<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<body bgcolor="white">
<p>
This package provides classes for users  who need finer control
on structured text handling.
In particular, the user should use the methods in the
<a href="IStructuredTextExpert.html">IStructuredTextExpert</a> class
in the following cases:</p>
<ul>
  <li>The structured type handler to use is not one of those
      predefined in <a href="../StructuredTextTypeHandlerFactory.html">
      StructuredTextTypeHandlerFactory</a>.</li>
  <li>A non-default <a href="StructuredTextEnvironment.html">
      environment</a> needs to be specified.</li>
  <li>A call to a method processing a piece of text may create a state
      which affects the processing of the next piece of text.</li>
  <li>The user needs to manage the offsets where directional formatting
      characters are inserted in the text.</li>
</ul>
<p>
Note that the basic functions are provided in package
<a href="../package-summary.html">
org.eclipse.equinox.bidi</a> and its
<a href="../StructuredTextProcessor.html">StructuredTextProcessor</a> class.
</p><p>
To access the more sophisticated methods for processing structured text,
the user should proceed as follows:</p>
<ul>
  <li>The user has to obtain an appropriate 
      <code>IStructuredTextExpert</code> instance using the methods in 
      <a href="StructuredTextExpertFactory.html">StructuredTextExpertFactory</a>.</li>
  <li>The user may then invoke the more sophisticated methods provided by
      <a href="IStructuredTextExpert.html">IStructuredTextExpert</a> 
      for processing the structured text.</li>
  <li>If those methods should work in an environment different from the default,
      the user may specify properties of the environment using the class
      <a href="StructuredTextEnvironment.html">StructuredTextEnvironment</a>.
      <p>
      This should be done before obtaining a <code>IStructuredTextExpert</code> instance, 
      and the specific environment must be specified when invoking 
      <code>StructuredTextExpertFactory</code> methods. This will 
      associate a type handler with the given environment and provide
      a customized <code>IStructuredTextExpert</code> instance to the user.</p></li>
</ul>

</body>
</html>
